Added document to collate information regarding distro-specific

incompatibilities in the commands that we are using in the scripts.

Signed-off-by: Ewan Mellor <ewan@xensource.com>

diff --git a/tools/examples/README.incompatibilities b/tools/examples/README.incompatibilities
new file mode 100644 (file)
index 0000000..2d2c950
--- /dev/null
+++ b/tools/examples/README.incompatibilities
@@ -0,0 +1,25 @@
+Command Incompatibilities
+=========================
+
+Known incompatibilities with various commands on various distributions, and
+the workarounds we use.
+
+
+brctl
+-----
+
+brctl show <bridge> fails on SLES9 SP2.  Workaround is to use brctl show
+without arguments, and grep, though this would be difficult were you to need
+to check for a specific bridge-interface pair, since brctl does not show the 
+bridge name on every line.
+
+
+ifup / ifdown
+-------------
+
+SuSE requires an extra parameter to ifup, which is created by calling getcfg
+appropriately.  See xen-network-common.sh for details.
+
+Gentoo doesn't have ifup/ifdown; appropriate alternatives are defined in
+xen-network-common.sh.
+